---
title: Deployment approval policies
description: To enable effective governance and control across DataRobot, admins can create and modify global approval policies for deployment-related activities.

---

# Deployment approval policies {: #deployment-approval-policies }

!!! info "Availability information"
     **Required permission:** "Can Manage Approval Policies"

To enable effective governance and control across DataRobot, you can create approval policies for deployment-related activities. Approval policies help ensure that [DataRobot deployments](deployment/index) are being produced and used safely with the necessary guardrails in place.

Administrators can [create policies](#create-an-approval-policy) from the **Approval Policies** page, or [use an existing policy as a template](#use-templates-to-create-policies). Once created, you can perform a variety of [actions](#approval-policy-actions) to manage approval policies. Note that the policies an administrator sees are specific to their organization&mdash;each organization may have its own approval policies configured.

##  Create an approval policy {: #create-an-approval-policy }

To create a new deployment approval policy, click on your user icon and navigate to the **Approval Policies** page. This page is also accessible from the app administrator page.

![](images/approval-1.png)

###  Create a new policy {: #create-a-new-policy }

To create a new approval policy, select **Create new policy**.

![](images/approval-2.png)

Begin completing the required fields for the new approval policy:

1. Select a policy trigger. This is the deployment event that triggers the approval workflow for [reviewers](dep-admin): deployment creation, deletion, importance changes, and model replacements. You must also indicate the importance level required for the event to trigger the approval policy (critical, high, moderate, low, any, or all levels above moderate).

	![](images/approval-3.png)


2. Add the user groups that can trigger the approval policy (optional). Start typing a group name and select the groups you want to include. If no groups are specified, the policy applies to all users in the organization.

	![](images/approval-4.png)


3. Assign the reviewers (optional). These are the users (or groups) that, when the policy is triggered, can review the deployment event to approve it or request changes. Once a user is added as a reviewer, they gain access to each deployment that triggers the policy and are notified when a review is requested. All MLOps Admins in the organization have reviewer permissions by default, and serve as the reviewers if none are specified.

	![](images/approval-5.png)


4. Configure the reminder settings for reviewers.

	![](images/approval-6.png)

	Use the toggles to:

	* Automatically send reminders to reviewers. Set the reminder frequency (every 12 hours, 24 hours, 3 days, or 7 days).
	* Assign an automatic action if a deployment event is not reviewed. Choose the action and when to apply it. For example, you can cancel a model replacement if the event was not reviewed within 7 days of the request for review.

5. Name the policy. Once you have fully configured the settings for your new approval policy, click **Save Policy**.

	![](images/approval-7.png)

Once saved, approval policies can be viewed from the **Approval Policies** page.

![](images/approval-8.png)

###  Use templates to create policies {: #use-templates-to-create-policies }

Any approval policy can serve as a template for a new policy. To use a template, select **Add policies from templates**.

![](images/approval-16.png)

The following policies are provided by default, covering the four deployment events available as policy triggers.

![](images/approval-14.png)

1. Choose the policy you want to serve as a template and click the copy icon under the **Actions** header.

	![](images/approval-9.png)

2. This brings you to the [policy creation](#create-an-approval-policy) page. The user groups that trigger the policy, the reviewers, and the reminder settings are carried over from the existing template policy. You must provide a new policy trigger and optionally list the groups for which you want to apply the policy.

	![](images/approval-15.png)

3. Complete the fields and click **Save Policy**. The new policy created with the template can be viewed from the **Approval Policies** page.


##  Approval policy actions {: #approval-policy-actions }

After creating policies, there are multiple activities available for managing them: [editing](#edit-existing-policies), [pausing](#pause-policies), and [deletion](#delete-policies).

###  Edit existing policies {: #edit-existing-policies }

To edit the configuration of an existing policy, access it from the **Approval Policies** page. Hover on the field you want to change and select **Edit**.

![](images/approval-10.png)

After editing the field, click **Save Change** to apply the edits.

###  Pause policies {: #pause-policies }


If you want to temporarily disable a policy, you can do so from the **Approval Policies** page. Under the **Actions** header, select the pause icon (![](images/icon-pause.png)). Once enabled, the pause icon is replaced with a play icon (![](images/icon-play.png)). Select it to re-enable the policy.

###  Delete policies {: #delete-policies }

You can permanently delete an approval policy by selecting the trash can icon under the **Actions** header.

![](images/approval-13.png)

A modal prompts you to confirm the deletion, warning that the automated action set up for the policy will automatically be applied to any deployments awaiting approval at the time of deletion. If no automated action was configured, the deployments need to be manually resolved. Confirm deletion by selecting **Yes, remove policy**. The approval policy will no longer appear on the **Approval policies** page.

![](images/approval-14.png)
